home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / lang / Jax4th.readme < prev    next >
Encoding:
Text File  |  1996-10-11  |  8.0 KB  |  245 lines
  1. Short:    ANS Forth interpreter
  2. Author:   jax@cygnus.com (Jack J. Woehr)
  3. Uploader: hauben00@marvin.informatik.uni-dortmund.de (Stefan Haubenthal)
  4. Version:  3.17
  5. Type:     dev/lang
  6.  
  7. Jax4th for the Commodore Amiga Copyright 1991, 1993, 1994 Jack J. Woehr
  8. jax@well.sf.ca.us jax@cygnus.com SYSOP RCFB (303) 278-0364
  9. -----------------------------------------------------------------------
  10. This is free software and can be modified and redistributed under
  11. certain conditions described in the file COPYING.TXT. The
  12. Disclaimer of Warranty and License for this free software are also
  13. contained in the file COPYING.TXT.
  14.  
  15. This is Jax's free ANS Forth for the Commodore Amiga. For more information
  16. on ANS Forth, contact the X3J14 Technical Committee via email at
  17.  
  18.     ansforth-request@minerva.com
  19.  
  20. or contact the
  21.  
  22.     American National Standards Institute
  23.     11 W. 42nd Street
  24.     New York NY 10036
  25.  
  26. The source and documentation were prepared using Amiga MicroEmacs.
  27.  
  28. Listing of archive:  'JX4A0317.LZH'
  29. Original Packed Ratio  Date     Time   Type  CRC  Name
  30. -------- ------  --- -------- -------- ----- ---- ------------
  31.    15230   6277  59% 05-17-94 13:22:26 -lh1- 38BF COPYING.TXT
  32.     1827    853  54% 05-17-94 13:22:14 -lh1- 58F4 DEFIMAGE.A
  33.   131280   2953  98% 05-17-94 13:22:24 -lh1- 50CB DEFIMAGE.JX4
  34.       52     43  18% 05-17-94 13:22:12 -lh1- B73C DEFIMAGE.LNK
  35.       94     74  22% 05-17-94 13:22:12 -lh1- DD3A DEFIMAGE.MAKE
  36.       92     62  33% 05-17-94 13:22:12 -lh1- 3BA8 DEFIMAGE.WITH
  37.    37188  18371  51% 05-17-94 13:22:16 -lh1- 1E16 JAX4TH
  38.   193700  60208  69% 05-17-94 13:22:10 -lh1- 88D9 JAX4TH.A
  39.    14329   5648  61% 05-17-94 13:22:00 -lh1- 90A1 JAX4TH.I
  40.       43     37  14% 05-17-94 13:21:58 -lh1- 3AE9 JAX4TH.LNK
  41.      168    113  33% 05-17-94 13:21:58 -lh1- 30C8 JAX4TH.MAKE
  42.       65     51  22% 05-17-94 13:22:00 -lh1- AE5D JAX4TH.WITH
  43.       26     24   8% 05-17-94 13:21:58 -lh1- B96C MAKEALL
  44.     5237   1936  64% 05-17-94 13:22:32 -lh1- 9734 demo/DEMO.F
  45.      436    318  28% 05-17-94 13:22:30 -lh1- 5D7F doc/JAX4TH.BUGS
  46.    33704  14149  59% 05-17-94 13:22:28 -lh1- 2DDD doc/JAX4TH.DOC
  47.     2462   1094  56% 05-17-94 13:22:28 -lh1- 7B80 doc/JAX4TH.INTERNALS
  48.    19267   7664  61% 05-17-94 13:22:30 -lh1- 3327 doc/JAX4TH.WORDS
  49.     6684   3202  53% 05-17-94 13:43:06 -lh1- EEA1 READ_1ST.TXT
  50. -------- ------  ---
  51.   461884 123077  74%       19 file(s)
  52. Operation successful
  53.  
  54. Files in this distribution
  55. --------------------------
  56. DEFIMAGE.A
  57. C.A.P.E. source code for the default local image of JAX4TH.
  58.  
  59. DEFIMAGE.JX4
  60. The default local image to be loaded by JAX4TH in the case of the
  61. latter's being invoked from a command line interface without an image
  62. file argument. In later versions, double-clicking <name>.JX4.info will
  63. invoke JAX4TH on the given image.
  64.  
  65. DEFIMAGE.LNK
  66. Link commands for linking DEFIMAGE.JX4.
  67.  
  68. DEFIMAGE.MAKE
  69. Amiga script file to make DEFIMAGE.JX4.
  70.  
  71. DEFIMAGE.WITH
  72. A "with" file for the linking process.
  73.  
  74. DISTRIB.TXT
  75. This description of the current distribution and restrictions (if any)
  76. on re-distribution by the user.
  77.  
  78. JAX4TH
  79. Relocatable re-entrant dpANS-2-compliant Forth kernel suitable
  80. for PURE bit protection under AmigaDOS.
  81.  
  82. JAX4TH.A
  83. C.A.P.E. source code for the re-entrant kernel JAX4TH.
  84.  
  85. JAX4TH.BUGS
  86. Some bugs from the known bug list.
  87.  
  88. JAX4TH.I
  89. Includes, macros for JAX4TH.A and DEFIMAGE.A.
  90.  
  91. JAX4TH.DOC
  92. An informational file which assumes 1) that the reader has
  93. systems programmer familiarity with the Commodore Amiga 500/1000/200,
  94. and 2) that the reader is familiar with Forth, and with the particulars
  95. of the draft proposed ANS Forth promulgated by the ANS X3/X3J14 Technical
  96. Committee for an American National Standard Forth.
  97.  
  98. JAX4TH.LNK
  99. Linker command file for JAX4TH.
  100.  
  101. JAX4TH.MAKE
  102. Amiga script file to make JAX4TH.
  103.  
  104. JAX4TH.WITH
  105.  
  106. A "with" file for the linking process.
  107.  
  108. JAX4TH.WORDS
  109. This is a listing with stack diagrams of the words in the FORTH-WORDLIST
  110. and a listing with stack diagrams and explanations of the words in the
  111. IMPLEMENTOR-WORDLIST.
  112.  
  113. Also ...
  114.  
  115. COPYING.TXT
  116. The GNU Public License.
  117.  
  118. READ_1ST.TXT
  119. This file.
  120.  
  121. Quickstart Instructions
  122. -----------------------
  123.  
  124.     1) Make a logical device (e.g., via AmigaDOS ASSIGN) name JX4:
  125.  
  126.     2) Copy JAX4TH and DEFIMAGE.JX4 to JX4:
  127.  
  128.     3) Optionally, at the AmigaDOS prompt type
  129.  
  130.         RESIDENT JX4:JAX4TH
  131.  
  132.     to make JAX4TH resident
  133.  
  134.     4) From a NEWCON: (NewShell) window, type
  135.  
  136.         JAX4TH
  137.  
  138.     to launch an instance of JAX4TH. You can launch as many
  139.     instances from as many NewShell windows as you like. Type
  140.     INSTANCES in JAX4TH and it will return on the stack the number
  141.     of instances of JAX4TH currently running. DO NOT "RUN" JAX4TH.
  142.  
  143.     5) BYE exits the current instance of JAX4TH and decrements INSTANCES
  144.     but does not clean up any resources allocated by the programmer: open
  145.     files, allocations via the MEMORY wordlist words, resources allocated
  146.     via direct CALLs to the Amiga operating system, etc. must be cleaned
  147.     up by the program.
  148.  
  149. BUGS
  150. ------
  151. See JAX4TH.BUGS
  152.  
  153. THANX
  154. -----
  155.     - To Steven Sarns, President of Vesta Technology, for his
  156.     support of X3J14 and my attendance thereto.
  157.  
  158.     - To Steven R. Wheeler for moral support, clever suggestions,
  159.     and debugging assistance.
  160.  
  161.     - To all the members of X3J14 and to chair E. Rather,
  162.     to vice-chair Andy Kobziar, and to TSC chair G. Bailey.
  163.  
  164.     - To Wil Baden, Forth Algorithmist Emeritus.
  165.  
  166.     - To Peter Appelman, a friend.
  167.  
  168.     - To the members of the Forth Interest Group, who taught
  169.     me Forth and gave me a new career.
  170.  
  171.     - To Darren & BJ of AMIGA PRO/AM on GEnie, who in 1989 asked me
  172.     the $64,000 question, "A Forth load library? Why? Why not just
  173.     write a PURE RESIDENT-able Forth?"
  174.  
  175.     - To Wes Howe and to Innovatronics for C.A.P.E.
  176.  
  177.     - and lastest and mostest, To my wife and children, who accept
  178.     that Dad stays up late a lot in the basement.
  179.  
  180. << END of DISTRIB.TXT >>
  181.  
  182. Release notes:
  183.  
  184. 0.dpANS-6.3.16    - dpANS-6 compliance. Fixed bug which prevented control
  185.         structures from spanning lines in INCLUDED files.
  186.  
  187. 0.dpANS-2.3.11    - fixed bug in system calls to Amiga OS.
  188.  
  189. 0.dpANS-2.3.10    - Fixed some minor bugs.
  190.  
  191. 0.dpANS-2.3.08    - Added SAVE-IMAGE and AUTOSTART to effect saving custom
  192.           images for later reload and autostart.
  193.  
  194. 0.dpANS-2.3.06    - Added command-line loading of custom image file. Minor
  195.           bug fixes.
  196.  
  197. 0.dpANS-2.3.04    -  S"  now complies with the description in the FILE
  198.            wordlist, i.e., it works interpretively at not just
  199.            as a compilation tool.
  200.  
  201. 0.dpANS-2.3.03    -  J   fixed, wouldn't work inside branch constructs.
  202.  
  203. 0.dpANS-2.3.02    -  I   fixed, wouldn't work inside branch constructs.
  204.         -  M*  was accidentally non-findable, now findable.
  205.  
  206. 0.dpANS-2.3.01    -  CALL  to Amiga OS now supported, see JAX4TH.DOC and
  207.           JAX4TH.WORDS. 91-09-07.
  208.  
  209. 0.dpANS-2.2.28    - First public release 91-09-01.
  210.  
  211. BUG REPORTS AND SUGGESTED IMPROVEMENTS TO:
  212. Jax
  213. PO Box 51
  214. Golden, CO 80402-0051
  215. jax@cygnus.com    <<== preferred
  216. jax@well.sf.ca.us
  217. 72203.1320@compuserve.com
  218.  
  219.  
  220. ============================= Archive contents =============================
  221.  
  222. Original  Packed Ratio    Date     Time    Name
  223. -------- ------- ----- --------- --------  -------------
  224.    15230    5853 61.5% 17-May-94 13:22:26 +COPYING.TXT
  225.     1827     795 56.4% 17-May-94 13:22:14 +DEFIMAGE.A
  226.   131280     315 99.7% 17-May-94 13:22:24 +DEFIMAGE.JX4
  227.       52      52  0.0% 17-May-94 13:22:12 +DEFIMAGE.LNK
  228.       94      73 22.3% 17-May-94 13:22:12 +DEFIMAGE.MAKE
  229.       92      69 25.0% 17-May-94 13:22:12 +DEFIMAGE.WITH
  230.     5237    1834 64.9% 17-May-94 13:22:32 +DEMO.F
  231.      436     288 33.9% 17-May-94 13:22:30 +JAX4TH.BUGS
  232.    33704   12924 61.6% 17-May-94 13:22:28 +JAX4TH.DOC
  233.     2462    1013 58.8% 17-May-94 13:22:28 +JAX4TH.INTERNALS
  234.    19267    7140 62.9% 17-May-94 13:22:30 +JAX4TH.WORDS
  235.    37188   17091 54.0% 17-May-94 13:22:16 +JAX4TH
  236.   193700   54695 71.7% 17-May-94 13:22:10 +JAX4TH.A
  237.    14329    5275 63.1% 17-May-94 13:22:00 +JAX4TH.I
  238.       43      43  0.0% 17-May-94 13:21:58 +JAX4TH.LNK
  239.      168     106 36.9% 17-May-94 13:21:58 +JAX4TH.MAKE
  240.       65      61  6.1% 17-May-94 13:22:00 +JAX4TH.WITH
  241.       26      26  0.0% 17-May-94 13:21:58 +MAKEALL
  242.     6684    3045 54.4% 17-May-94 13:44:34 +READ_1ST.TXT
  243. -------- ------- ----- --------- --------
  244.   461884  110698 76.0% 04-Oct-96 00:29:34   19 files
  245.